Developer --> Technical Publications
PATH Hardware Documentation > Device Managers and Drivers > ATA Devices > ATA Device Software Guide


ATA_GetLocationIcon

The ATA_GetLocationIcon function returns a pointer to the structure defining the location icon data for the selected device. The structure contains the icon data and an icon string for the device.

The manager function code for the ATA_SetDevConfig function is $8C.

The parameter block associated with this function is defined as follows:

typedef struct
{
ataPBHdr /* ataPBHdr parameter block */
ulong iconData; /* Pointer to icon data and */
/* the size of the data */
} ATA_GetLocationIcon;

Field description

ataPBHdr
See the ataPBHdr parameter block definition.
iconData
This field contains two fields, a pointer to a structure that contains the icon data, and the size in bytes of the icon data. The structure that contains the actual icon data is defined as:

struct DriverLocationIcon
{
ushort   locationIcon[256];
char     locationString;
} DriverLocationIcon;

The locationIcon field is the device icon data (fixed 256 bytes). The locationString field is string in C string format (null terminated).
RESULT CODES

See Table A-1 for possible result codes returned by the ATA Manager.


© 1999 Apple Computer, Inc. — (Last Updated 30 Oct 97)

Previous | Back Up One Level | Next | Show Frames | Hide Frames